Skip to content

📖 docs: Update argocd-agent solution to use clusteradm#1348

Merged
openshift-merge-bot[bot] merged 1 commit intoopen-cluster-management-io:mainfrom
mikeshng:argocd-agent
Jan 29, 2026
Merged

📖 docs: Update argocd-agent solution to use clusteradm#1348
openshift-merge-bot[bot] merged 1 commit intoopen-cluster-management-io:mainfrom
mikeshng:argocd-agent

Conversation

@mikeshng
Copy link
Member

@mikeshng mikeshng commented Jan 25, 2026

Summary

docs: Update argocd-agent solution to use clusteradm

Related issue(s)

Refs:

Summary by CodeRabbit

  • Documentation
    • Updated setup guide with streamlined installation process
    • Added validation steps to verify addon status deployment
    • Enhanced deployment workflow documentation for improved clarity on namespace handling

✏️ Tip: You can customize this high-level summary in your review settings.

Signed-off-by: Mike Ng <ming@redhat.com>
@openshift-ci openshift-ci bot requested review from jnpacker and qiujian16 January 25, 2026 23:31
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Jan 25, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: mikeshng

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@coderabbitai
Copy link

coderabbitai bot commented Jan 25, 2026

Walkthrough

Updates documentation for the ArgoCD agent addon installation process. Replaces Helm CLI references with clusteradm CLI in prerequisites, installation commands, and validation procedures. Modifies namespace creation workflow and removes CreateNamespace syncOption from the Application configuration.

Changes

Cohort / File(s) Summary
ArgoCD Agent Documentation
solutions/argocd-agent/README.md
Updated installation instructions from Helm CLI to clusteradm CLI; modified prerequisites, setup guide heading, and validation steps; adjusted namespace creation workflow by removing CreateNamespace syncOption

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested labels

lgtm

Suggested reviewers

  • jnpacker
  • qiujian16
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main change: updating the argocd-agent solution documentation to use clusteradm instead of Helm.
Description check ✅ Passed The description includes a clear summary and related issue references, matching the template structure with all required sections completed appropriately.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@mikeshng
Copy link
Member Author

/assign @xiangjingli

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@solutions/argocd-agent/README.md`:
- Line 90: The README currently shows an incorrect clusteradm command using the
addon name "argocd-agent" and an unsupported flag "--create-namespace"; update
the invocation of clusteradm (the line containing "clusteradm install
hub-addon") to use the correct addon name "argocd" and remove the unsupported
"--create-namespace" flag so the command becomes "clusteradm install hub-addon
--names argocd".
🧹 Nitpick comments (1)
solutions/argocd-agent/README.md (1)

170-177: Document the workflow change from auto-namespace creation to manual.

The shift from using syncOptions: CreateNamespace=true (auto-creation) to requiring manual namespace creation on the managed cluster is a significant workflow change. Consider:

  • Adding an explanation of why manual namespace creation is now required (is this specific to clusteradm, ArgoCD Agent behavior, or a best practice?)
  • Including a migration note if this affects existing users with Applications that currently use CreateNamespace=true
  • Clarifying whether the namespace must be created on the managed cluster vs. hub cluster for other modes
📝 Suggested documentation enhancement

Consider adding a note before line 170:

> **Note:** The ArgoCD Agent requires the target namespace to exist on the managed cluster before application deployment. 
> Unlike standalone ArgoCD, the `CreateNamespace` syncOption is not used in this workflow because [add reason].

@qiujian16
Copy link
Member

/lgtm

@openshift-ci openshift-ci bot added the lgtm label Jan 29, 2026
@openshift-merge-bot openshift-merge-bot bot merged commit 4ec68fd into open-cluster-management-io:main Jan 29, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants